home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / X11 / xmessage.z / xmessage
Encoding:
Text File  |  1998-10-30  |  8.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22220000 AAAAuuuugggguuuusssstttt 1111999999991111))))       XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xmessage - display a message or query in a window (X-based
  10.           /bin/echo)
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           xxxxmmmmeeeessssssssaaaaggggeeee [ ----bbbbuuuuttttttttoooonnnnssss _l_a_b_e_l_1[:_v_a_l_u_e_1],,,,_l_a_b_e_l_2[:_v_a_l_u_e_2],,,,... ] [
  14.           _o_p_t_i_o_n_s ] ----ffffiiiilllleeee _f_i_l_e_n_a_m_e
  15.           xxxxmmmmeeeessssssssaaaaggggeeee [ ----bbbbuuuuttttttttoooonnnnssss _l_a_b_e_l_1[:_v_a_l_u_e_1],,,,_l_a_b_e_l_2[:_v_a_l_u_e_2],,,,... ] [
  16.           _o_p_t_i_o_n_s ] _m_e_s_s_a_g_e ...
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           _X_m_e_s_s_a_g_e displays a window containing a message from the
  20.           command line, a file, or standard input.  Along the lower
  21.           edge of the message is row of buttons; clicking the left
  22.           mouse button on any of these buttons will cause _x_m_e_s_s_a_g_e to
  23.           exit.  Which button was pressed is returned in the exit
  24.           status and, optionally, by writing the label of the button
  25.           to standard output.
  26.  
  27.           _X_m_e_s_s_a_g_e is typically used by shell scripts to display
  28.           information to the user or to ask the user to make a choice.
  29.  
  30.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  31.           These are the command line options that _x_m_e_s_s_a_g_e
  32.           understands.
  33.  
  34.           ----bbbbuuuuttttttttoooonnnnssss _b_u_t_t_o_n,_b_u_t_t_o_n,...
  35.                   This option will cause _x_m_e_s_s_a_g_e to create one button
  36.                   for each comma-separated _b_u_t_t_o_n argument.  The
  37.                   corresponding resource is bbbbuuuuttttttttoooonnnnssss.  Each _b_u_t_t_o_n
  38.                   consists of a label optionally followed by a colon
  39.                   and an exit value.  The label is the name of the
  40.                   Command button widget created and will be the
  41.                   default text displayed to the user.  Since this is
  42.                   the name of the widget it may be used to change any
  43.                   of the resources associated with that button.  The
  44.                   exit value will be returned by _x_m_e_s_s_a_g_e if that
  45.                   button is selected.  The default exit value is 100
  46.                   plus the button number.  Buttons are numbered from
  47.                   the left starting with one.  The default string if
  48.                   no ----bbbbuuuuttttttttoooonnnnssss option is given is ooookkkkaaaayyyy::::0000.
  49.  
  50.           ----ddddeeeeffffaaaauuuulllltttt _l_a_b_e_l
  51.                   Defines the button with a matching _l_a_b_e_l to be the
  52.                   default.  If not specified there is no default.  The
  53.                   corresponding resource is ddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn.  Pressing
  54.                   Return anywhere in the _x_m_e_s_s_a_g_e window will activate
  55.                   the default button.  The default button has a wider
  56.                   border than the others.
  57.  
  58.           ----ffffiiiilllleeee _f_i_l_e_n_a_m_e
  59.                   File to display.  The corresponding resource is
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22220000 AAAAuuuugggguuuusssstttt 1111999999991111))))       XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))
  71.  
  72.  
  73.  
  74.                   ffffiiiilllleeee.  A _f_i_l_e_n_a_m_e of `----' reads from standard input.
  75.                   If this option is not supplied, _x_m_e_s_s_a_g_e will
  76.                   display all non-option arguments in the style of
  77.                   _e_c_h_o.  Either ----ffffiiiilllleeee or a message on the command line
  78.                   should be provided, but not both.
  79.  
  80.           ----pppprrrriiiinnnntttt  This will cause the program to print the label of
  81.                   the button pressed to standard output.  Equivalent
  82.                   to setting the pppprrrriiiinnnnttttVVVVaaaalllluuuueeee resource to TRUE.  This is
  83.                   one way to get feedback as to which button was
  84.                   pressed.
  85.  
  86.      WWWWIIIIDDDDGGGGEEEETTTT HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
  87.           Knowing the name and position in the hierarchy of each
  88.           widget is useful when specifying resources for them.  In the
  89.           chart below, the class and name of each widget is given.
  90.  
  91.           Xmessage (xmessage)
  92.                Form form
  93.                     Label message
  94.                     Command (label1)
  95.                     Command (label2)
  96.                     .
  97.                     .
  98.                     .
  99.  
  100.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  101.           _X_m_e_s_s_a_g_e has a few top-level application resources that
  102.           allow customizations that are specific to _x_m_e_s_s_a_g_e.
  103.  
  104.           ffffiiiilllleeee    A String resource specifying the file to display.
  105.  
  106.           bbbbuuuuttttttttoooonnnnssss A String resource specifying the buttons to display.
  107.                   See the ----bbbbuuuuttttttttoooonnnnssss command-line option.
  108.  
  109.           ddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn
  110.                   A String resource specifying a default button by
  111.                   label.
  112.  
  113.           pppprrrriiiinnnnttttVVVVaaaalllluuuueeee
  114.                   A Boolean resource that determines whether or not
  115.                   the label of the button pressed to exit the program
  116.                   is printed.  The default is FALSE.
  117.  
  118.      AAAACCCCTTTTIIIIOOOONNNNSSSS
  119.           eeeexxxxiiiitttt((((_v_a_l_u_e))))
  120.                   exit immediately with an exit status of _v_a_l_u_e
  121.                   (default 0).  This action can be used with
  122.                   translations to provide alternate ways of exiting
  123.                   _x_m_e_s_s_a_g_e.
  124.  
  125.           ddddeeeeffffaaaauuuulllltttt----eeeexxxxiiiitttt(((())))
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))       XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22220000 AAAAuuuugggguuuusssstttt 1111999999991111))))       XXXXMMMMEEEESSSSSSSSAAAAGGGGEEEE((((1111))))
  137.  
  138.  
  139.  
  140.                   exit immediately with the exit status specified by
  141.                   the default button.  If there is no default button,
  142.                   this action has no effect.
  143.  
  144.      EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  145.           If it detects an error, _x_m_e_s_s_a_g_e returns 1, so this value
  146.           should not be used with a button.
  147.  
  148.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.           _X(1), _e_c_h_o(1), _c_a_t(1)
  150.  
  151.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  152.           Copyright 1988,1991 Massachusetts Institute of Technology.
  153.           See _X(1) for a full statement of rights and permissions.
  154.  
  155.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  156.           Chris Peterson, MIT Project Athena
  157.           Stephen Gildea, MIT X Consortium
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.